6.5 KB • ⇊ 3 parts • ⤓ Micron 6.5 KB • ⤓ HTML 26.0 KB

Manual: The rngit Utility ↗

rngit is a utility bundled with RNS that provides full Git repository hosting and interaction over Reticulum, including task management, release distribution and NomadNet project pages.

It consists of the rngit CLI program for hosting and managing repositories, and the git-remote-rns remote helper that enables Git to communicate with rngit nodes. Once installed, it is possible to interact with Git repositories over Reticulum using the rns:// URI scheme.cite-ref-1[1]

• Work documents

• Repository structure

• Subcommands

• Tips and tricks

• Install/update Python packages

• Official repositories

• References

• External links

Rather than a traditional issue queue, rngit provides a work document management system (docs) for tracking tasks, investigations, issues and progress related to repositories. Users may be granted permission to create and push work document proposals over the network.

Repositories are organized into groups, each group being a directory containing bare Git repositories. A bare repository can be obtained with git clone --bare <URL>. Locations and permissions of groups may be configured in rngit's configuration file.

• rngit create (manual ↗)

• rngit fork (manual ↗)

• rngit mirror (manual ↗)

• rngit perms (manual ↗)

• rngit release (manual ↗)

• rngit sync (manual ↗)

• rngit work (manual ↗)

It's possible to check, fetch, verifycite-ref-2[2] and install/update Python packages released as wheels as a one-liner:

Installing Python packages with rngit is more secure than using pip install, as pip doesn't verify releases or check signatures when installing from PyPi.

The third-party tool pip-rns provides a more streamlined experience when installing Python packages from rngit remotes. It supports pip, pipx, uv, and poetry backends, version pinning, signature verification, aliases, indexes, offline bundles, and more.

Reticulum is fully self-hosted and developed on Reticulum itself.

• RNS: rns://7649a50d84610232d1416b41d2896aff/reticulum/reticulum (Aleph Git ↗)

• LXMF: rns://7649a50d84610232d1416b41d2896aff/reticulum/lxmf (Aleph Git ↗)

• LXST: rns://7649a50d84610232d1416b41d2896aff/reticulum/lxst (Aleph Git ↗)

• NomadNet: rns://7649a50d84610232d1416b41d2896aff/reticulum/nomadnet (Aleph Git ↗)

• Sideband: rns://7649a50d84610232d1416b41d2896aff/reticulum/sideband (Aleph Git ↗)

• Website: rns://7649a50d84610232d1416b41d2896aff/reticulum/website (Aleph Git ↗)

cite-note-11. ↑ Git Over Reticulum, Manual. a8d24177d946de4f1f0a0fe1af9a1338:/page/blob.mu ↗

cite-note-22. ↑ Verified Releases, Manual. a8d24177d946de4f1f0a0fe1af9a1338:/page/blob.mu ↗

• Git Over Reticulum in the manual

• Distributed Development in the manual

rncp • rngit • rnid • rnir • rnodeconf • rnpath • rnpkg • rnprobe • rnsh • rnstatus • rnx